Determines if a specific event should be handled by the application or the Operating System.

Boolean SystemEvent (
    const EventRecord *theEvent
);

theEvent

A pointer to the event structure for the event.

DISCUSSION

The WaitNextEvent and the GetNextEvent functions call the SystemEvent function. In most cases your application should not call the SystemEvent function.

SystemEvent returns false as its function result if the event should be handled by the application; otherwise, SystemEvent takes any appropriate actions and returns true.

For activate, update, mouse-up, and keyboard events (including keyboard equivalents of commands), SystemEvent checks to see whether the active window belongs to a desk accessory and whether that desk accessory can handle that type of event. If so, SystemEvent sends the event to the desk accessory and returns true. Otherwise, SystemEvent returns false.

For mouse-down events and null events, SystemEvent returns false.

For disk-inserted events, SystemEvent attempts to mount the disk using the PBMountVol function but returns false so that the application can perform further processing if necessary.

See “EventMask Constant” for a discussion of the fields in the event structure.

AVAILABILITY

Not supported in Carbon. Not available in Carbon.

CARBON NOTES

Desk accessories are not supported in Carbon.

© 2000 Apple Computer, Inc. — (Last Updated 5/8/2000)